home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 101-125 / scopedisk114 / dgplot / dgplot.doc < prev    next >
Text File  |  1995-03-19  |  16KB  |  373 lines
  1.                           DGplot Version 0.07                          
  2.                    By John (the Amiga Kid) Robertson                   
  3.  
  4.  
  5. DGplot is copyright (c) 1990 by John Dillard Robertson, 28 Pinckney St.
  6. #4, Greenville, SC  29601,  (803) 271-1459 (voice), but may be freely
  7. distributed as long as no profit is made from its distribution or sale
  8. without my written permission.  This program is 'FreeWare'.
  9.  
  10. Included Support files:
  11.  
  12.    PrtDef (directory)       ... printer driver files
  13.  
  14.    arp.library              ... AmigaDOS Replacement Project library
  15.  
  16.    DGplot                   ... DGplot program executable file
  17.  
  18.    DGplot.doc               ... Documentation for DGplot (you are
  19.                                 looking at it)
  20.  
  21.    FastLib                  ... Fbasic support library required to run
  22.                                 programs compiled with the Fbasic compiler.
  23.  
  24.    NULL                     ... An empty file for PIPE: reads
  25.  
  26.    Plans-configuration      ... HPGL configuration file for "Plans"
  27.                                 shareware CAD program.
  28.  
  29.    RaceCar.D                ... Sample HPGL file.  "D" size drawing.
  30.  
  31.    SuperPlot.HP7550         ... Sample HPGL file.  "HP7550" size
  32.                                 drawing.
  33.  
  34.  
  35.                ------ What in the heck is DGplot? ------               
  36.  
  37. DGplot, or "darn good plot" is a program which turns your Amiga
  38. computer and parallel port dot matrix printer into an extremely high
  39. resolution Hewlett-Packard ® pen plotter.  This makes your printer a
  40. suitable (and economical) hard copy device for computer aided design
  41. programs, some spreadsheet programs, and data graphing programs.  You
  42. will probably be amazed when you see the resolution that your dot
  43. matrix printer really has.  DGplot output in FINAL quality will look
  44. much better than a screen dump.
  45.  
  46. DGplot reads (and understands) a useful subset of HPGL commands.  HPGL
  47. is an acronym for "Hewlett Packard Graphics Language", which is a
  48. language used to tell a pen plotter how to draw a picture.  HPGL files
  49. are ASCII files, so you can type them to the CLI window if you are
  50. curious.  HPGL has become a pseudo-standard plotter language in the
  51. computer industry, and is supported by all CAD programs.  DGplot has
  52. been tested with:
  53.  
  54.         - `Plans' shareware CAD program
  55.            (you must have the proper "plans-configuration" file which
  56.            is supplied with this program)                    
  57.  
  58.         - `X-CAD designer' commercial CAD program                
  59.  
  60.         - `SuperPlot' data graphing program (on this disk)         
  61.  
  62. DGplot should work fine with Aegis Draw (and all variants), IntroCad,
  63. and most other CAD programs.
  64.  
  65.                  ------ How do I set up DGplot? ------                 
  66.  
  67. Required Files:
  68.  
  69.  directory      file
  70. ----------   ----------
  71.       C:     DGplot
  72.  
  73.    LIBS:     arp.library
  74.  
  75.       S:     FastLib
  76.              DGprinter    (one of the included printer drivers renamed)
  77.  
  78. DGplot is designed to support just about any dot matrix printer on the
  79. market.  To accomplish this, DGplot must have a special printer driver
  80. file in your S: directory, named "DGprinter".
  81.  
  82. The DGplot printer driver is NOT the same as a preferences printer
  83. driver, so don't intermix them. 
  84.  
  85. DGplot printer drivers are compatible with most IntroCad ® printer
  86. drivers. If you look in the PrtDef directory you will find the names of
  87. many printers.  After you select the appropriate one, copy it to the S:
  88. directory, and rename it "DGprinter".  If you need to try several
  89. printer drivers, you can specify the printer driver on the command line
  90. (See Power Users section).
  91.  
  92. Copy the program file, "DGplot", into your C: directory, or somewhere
  93. in your assigned search path.  You must also copy the file "FastLib"
  94. into your S: directory, and the "arp.library" into your LIBS:
  95. directory.  If you are booting off of "Ultra_Bench", both files will
  96. already be there.
  97.  
  98. Please note:  Nothing you can set in Preferences will have any effect
  99. on DGplot.
  100.  
  101.                   ------ How do I use DGplot? ------                   
  102.  
  103. To use DGplot, simply type:
  104.  
  105.       DGplot HPGLfilename
  106.  
  107. into a CLI window where `HPGLfilename' is the name of an HPGL file. 
  108. You will be prompted with the following:
  109.  
  110.         Select a drawing size
  111.  
  112.  A       (8 x 10.5)      1000 units/inch
  113.  B       (10.5 x 16.5)   1000 units/inch
  114.  C       (16.25 x 21.25) 1000 units/inch
  115.  D       (21 x 33)       1000 units/inch
  116.  E       (33 x 43)       1000 units/inch
  117.  HP7475  (7.8 x 10.1)    1021 units/inch
  118.  HP7550  (7.7 x 10)      1016 units/inch
  119.  USER    Specify (? x ?) 1000 units/inch
  120.             (ESC) (CR) to abort
  121. ?
  122.  
  123. Reply with "A","B","C"..., or hit the ESC key and then RETURN to abort.
  124. DGplot will not alter the scaling of your drawing in any way, so make
  125. sure you choose the appropriate size for the drawing you would like to
  126. plot.  If you choose the "USER" selection you will be prompted for the
  127. desired width and height of the drawing.  A 1/2" border is assumed. 
  128. after making a valid choice, you will be prompted next with something
  129. like this:
  130.  
  131.  
  132.         Specify drawing quality
  133.  
  134.  QUICK
  135.  DRAFT
  136.  FINAL
  137.             (ESC) (CR) to abort
  138. ?
  139.  
  140. Reply by typing in one of the choices (upper or lower case doesn't
  141. matter).  If you have trouble, view the printer driver, which is an
  142. ASCII file.
  143.  
  144. If DGplot finds the selected entry in the printer driver, and the HPGL
  145. file is where you said that it was, you should see DGplot counting the
  146. kilobytes read from the file.  DGplot is now reading the file and
  147. building the internal vector lists.  If you wish to abort the file
  148. read, just activate the CLI window that DGplot is running from, and
  149. press CTRL-C simultaneously.
  150.  
  151. After DGplot finishes reading the HPGL file it will begin printing
  152. immediately.  You will see a status line printed which tell you how
  153. many strips and how many rows to go.  1 row = 1 printer head height,
  154. and 1 strip is one 8" wide portion of the drawing.  If you wish to
  155. abort the printing, just activate the CLI window that DGplot is running
  156. from, and press CTRL-C simultaneously.
  157.  
  158. If DGplot appears to be doing nothing, check to see that your printer
  159. is turned on, and "ON LINE".  If the drawing size you selected is 8" or
  160. more in its shortest dimension (including the border), the printer will
  161. print out several strips with alignment marks.  The strips should be
  162. separated and joined along the sides, with the alignment marks on top
  163. of each other.
  164.  
  165.            Strip #1                       Strip #2
  166.  ______________________________ ______________________________
  167.  |                            | |                            |
  168.  |       alignment mark---> + | | + <--- alignment mark      |
  169.  |                            | |                            |
  170.  |                            | |                            |
  171.  |                            | |                            |
  172.  |                            | |                            |
  173.  |                            | |                            |
  174.  |                            | |                            |
  175.  |                            | |                            |
  176.  |                            | |                            |
  177.  |............................| |............................|
  178.  |                            | |                            |
  179.  |                            | |                            |
  180.  |                            | |                            |
  181.  |                            | |                            |
  182.  |                            | |                            |
  183.  |                            | |                            |
  184.  |                            | |                            |
  185.  |                            | |                            |
  186.  |                            | |                            |
  187.  |                          + | | +                          |
  188.  |____________________________| |____________________________|
  189.  |   Tear here and join to    |               ^
  190.  | +        strip #1          |               |
  191.  |                            |               |
  192.  |                            |               |
  193.  |                            |               |
  194.  |                            |               |
  195.  |                            |               |
  196.  |                            |               |
  197.  |                            |<---------------
  198.  |                            |
  199.  |............................|
  200.  |                            |
  201.  |                            |
  202.  |                            |
  203.  |                            |
  204.  |                            |
  205.  |                            |
  206.  |                            |
  207.  |                            |
  208.  |                            |
  209.  | +                          |
  210.  |____________________________|
  211.  
  212. Since dot matrix printers can't print all of the way to the left edge
  213. of the paper, you will have to trim about 1/8" off of the left side of
  214. all strips after first.  DGplot gives you 1/4" of overlap between
  215. strips.  The best way to join the strips is to lay them on a large flat
  216. surface properly aligned, place a straight edge on the junction, and
  217. cut with a razor knife.  This will give an exact edge with no overlap
  218. necessary.
  219.  
  220.                        ------ Power Users ------                       
  221.  
  222. For all you power users out there, DGplot accepts any number of HPGL
  223. filenames on the command line, or any ARP wildcard pattern (The GADS
  224. command line parser is used).  You may also specify the size, width,
  225. height, print quality, and printer driver on the command line.  If you
  226. specify a size other than "USER", the width and height arguments will
  227. be ignored.  If you omit a necessary specification, you will be
  228. prompted for it.  Here is a fully specified example:
  229.  
  230.   DGplot t:*.plt -S user -W 10.0 -H 7.49 -Q draft -P PrtDrv/Epson-FX   
  231.  
  232.                                   or                                   
  233.  
  234.   DGplot t:*.plt -S hp7550 -Q draft -P PrtDrv/Epson-FX   
  235.  
  236. where * is a wildcard character.  If you use the command line options
  237. to specify size and print quality, DGplot can be run from script files.
  238.  
  239.  
  240.               ------ Reading from the PIPE: device ------              
  241.  
  242. HPGL files can be very large, and have little value in themselves. 
  243. This makes them a good candidate for the PIPE: device.  The PIPE:
  244. device was distributed on WorkBench 1.3, and on Ultra_Bench.  The PIPE:
  245. device is a 4K buffer that appears to a program as a file.  Using the
  246. PIPE: will eliminate the need to save the HPGL file to disk, and it
  247. will speed up the whole process of printing output.
  248.  
  249. To use the PIPE: with DGplot you must open a CLI window and make sure
  250. that the PIPE: is mounted by typing:
  251.  
  252.                               mount PIPE:                              
  253.  
  254. This will mount the PIPE: device if it has not already been mounted. 
  255. Now you should invoke DGplot with a valid PIPE: for the HPGLfilename. 
  256. For example:
  257.  
  258.               DGplot PIPE:A -S user -W 30 -H 20 -Q final               
  259.  
  260. The "PIPE:A" specification may be any string up to 30 characters as
  261. long as it starts out with "PIPE:".  After you hit RETURN, DGplot
  262. should report that it is reading PIPE:A, and should not be counting up.
  263. At this point, DGplot is waiting for some program to write to "PIPE:A".
  264.  
  265. Now go to your CAD program, or any program that outputs HPGL and plot
  266. your drawing by selecting the HPGL plotter option, and save output to
  267. "PIPE:A".  Now, if you flip back to the WorkBench screen, you should
  268. see the CLI window with DGplot running in it counting up the Kbytes
  269. read.
  270.  
  271. When your CAD program indicates that it has finished saving the HPGL
  272. plot file, DGplot may or may not start printing.  If it does not, it is
  273. still waiting for an `end of file' condition from the PIPE:.  To supply
  274. this I have included a file named "NULL", which is empty.  Open a
  275. second CLI window (it is important that it is not the same CLI window
  276. as DGplot is running from), and type:
  277.  
  278.                           type null to PIPE:A                          
  279.  
  280. This will send the `end of file' signal to DGplot, and it should start
  281. printing immediately.
  282.  
  283.  
  284.                         ------ Reference ------                        
  285.  
  286. HPGL commands currently supported with DGplot are:
  287.  
  288. AA - the Arc Absolute instruction
  289. CI - the Circle instruction
  290. DF - the Default instruction
  291. IN - the Initialize instruction
  292. PA - the Plot Absolute instruction
  293. PD - the Pen Down instruction
  294. PR - the Plot Relative instruction
  295. PU - the Pen Up instruction
  296. RO - the Rotate Coordinate System instruction
  297. LT - the Line Type instruction
  298.  
  299. All commands that are in an HPGL file and are not supported by DGplot
  300. will simply be ignored.  Since I am interested in making DGplot useful
  301. to as many people as possible, I will add support for commands that you
  302. request.
  303.  
  304.                        ------ Intentions ------                        
  305.  
  306. I do not wish to support all HPGL commands, since the size of the code
  307. and memory requirements would be very large.  DGplot and all vector
  308. lists currently take up about 120K of memory, depending on the size of
  309. the input file.  This makes it feasible to run DGplot while you are
  310. still running your CAD program.
  311.  
  312.                     ------ What's the Catch? ------                    
  313.  
  314. If you find a bug, I would appreciate it if you would tell me about it.
  315. It is very helpful if you can provide the HPGL file that made DGplot
  316. barf.  My address and phone number are:
  317.  
  318.                            John D. Robertson                           
  319.                           28 Pinckney St. #4                           
  320.                          Greenville, SC  29601                         
  321.                             (803) 271-1459                             
  322.  
  323. Any donations will be gleefully accepted, and donaters will recieve a
  324. reply in the mail.  Donations will provide incentive for future public
  325. domain programs.
  326.  
  327.  
  328.  
  329.                       ------ Future Plans ------                       
  330.  
  331. Thanks in part to my faithful alpha testers, I plan to do the
  332. following:
  333.  
  334. - Support a command which is not in the Hewlett Packard Graphics
  335.   Language, but would be useful for making printed circuit boards.  The
  336.   command will be "LW", for Line Width, and will have one argument. 
  337.   The argument will specify the line width in thousandths of an inch. 
  338.   To use this feature you simply assign the LW command instead of the
  339.   SP command in your plotter setup file for your CAD program.  This
  340.   will make each color of line on the screen represent a different
  341.   width of line on the hard copy.  (Thanks Jerry!)
  342.  
  343. - Support color (I need to get at least one request for this).
  344.  
  345. All suggestions will be appreciated and considered.
  346.  
  347. Thank you and enjoy DGplot!
  348.  
  349.                       ------ Release Notes ------                      
  350.  
  351.                         Version 0.03  (1/28/90)                        
  352.  
  353. Initial release.  Does not support HPGL "LT" command, so can't do line
  354. types.  Only accepts one HPGL file on the command line.
  355.  
  356.                         Version 0.06 (2/25/90)                         
  357.  
  358. Now supports "LT" command.  Supports ARP command line options with
  359. unlimited filenames, wild cards, and complete drawing specification
  360. from key words.  Requires the presence of the "arp.library" in the
  361. "LIBS:" directory.  Added "USER" drawing size where the user specifies
  362. the width and height of the drawing.  User may now break (ctrl-C) at
  363. any time during reading phase or printing phase.
  364.  
  365.                         Version 0.07 (3/3/90)                         
  366.  
  367. DGplot now prints out the available print quality entries from the
  368. printer driver that has been specified, so you can see all available
  369. choices.  If you incompletely specify either the size or print quality
  370. by using fewer characters than shown, DGplot will look for the first
  371. character for character match for what you have specified.  (Thanks
  372. Bernie!)
  373.